.TH AUDACIOUS "1" "May 2016" "Version @PACKAGE_VERSION@" "Audacious"

.SH NAME
audacious \- an advanced audio player.

.SH SYNOPSIS
.B audacious
[\fIoption\fR ...] [\fIfile\fR ...]

.SH DESCRIPTION
Audacious is a free advanced audio player for Linux and many other
UNIX-compatible systems.  It focuses on low resource usage, high audio quality,
and support for a wide range of audio formats.  It was originally based on Beep
Media Player, which was in turn based on XMMS.

.SH OPTIONS
.SS Getting help:

.TP
.B -h, --help
Show a brief list of options.

.SS Opening files:

.TP
.B -e, --enqueue
Add the files on the command line to the current playlist but do not start
playback.
.TP
.B -E, --enqueue-to-temp
Add the files on the command line to the ``Now Playing'' playlist and start
playback.

.SS Controlling playback:

.TP
.B -p, --play
Start playback.  If paused, playback will resume from the same point.  If
already active and not paused, it will restart from the beginning of the song.
.TP
.B -u, --pause
Pause playback, or resume if already paused.
.TP
.B -t, --play-pause
Equivalent to \fB--pause\fR if playback is active, otherwise \fB--play\fR.
.TP
.B -s, --stop
Stop playback.
.TP
.B -r, --rew
Skip to the previous song in the playlist.
.TP
.B -f, --fwd
Skip to the next song in the playlist.

.SS Miscellaneous:

.TP
.B -m, --show-main-window
Show the Audacious window if it is hidden and bring it to the top.
.TP
.B -j, --show-jump-box
Show the Jump to Song window.
.TP
.B -H, --headless
Start in command-line mode; i.e., without any graphical user interface.
.TP
.B -q, --quit-after-play
Exit as soon as playback stops, or immediately if there is nothing to play.
.TP
.B -v, --version
Print version information and exit.
.TP
.B -V, --verbose
Print debugging output while running (may be used twice for even more output).
.TP
.B -N, --new-instance
Starts a new instance.  The second instance started may be controlled with
\fBaudtool -2\fR, the third with \fBaudtool -3\fR, etc. (up to 9 instances).

.SH KEYBINDINGS
.ta 24
Control + Return	Play
.br
Space, Control + ,	Pause
.br
Control + .			Stop
.br
Alt + Up			Previous song
.br
Alt + Down			Next song
.br
Right arrow			Seek forward (by default 5 seconds)
.br
Left arrow			Seek backward (by default 5 seconds)
.br
Escape				Scroll to current song
.br
Control + a			Select all songs in playlist
.br
Shift + Control + a	Cancel selection
.br
Control + + (plus)	Increase volume 5 percent
.br
Control + - (minus)	Decrease volume 5 percent
.br
Control + s			Toggle shuffle
.br
Control + r			Toggle repeat
.br
Control + n			Toggle advancing in playlist
.br
Control + m			Toggle stopping after current song
.br
Control + e			Display Equalizer
.br
Control + y			Display Search Tool
.br
Control + i			Display Song Information dialog
.br
Control + k			Display Jump to Time dialog
.br
Control + j			Display Jump to Song dialog
.br
Control + p			Display Playlist Manager dialog
.br
Control + u			Display Queue Manager dialog
.br
Control + o			Display Open Files dialog
.br
Shift + Control + o	Display Add Files dialog
.br
Control + l			Display Open URL dialog
.br
Shift + Control + l	Display Add URL dialog

.SH FILES

.TP
~/.config/audacious/config, ~/.config/audacious-2/config, etc.
Configuration file for each Audacious instance.
.TP
~/.config/audacious/playlists, ~/.config/audacious-2/playlists, etc.
Folders in which playlists are stored.
.TP
~/.local/share/audacious/Skins, @datarootdir@/audacious/Skins
Default locations where Audacious should look for skin files.

.SH ENVIRONMENT

.TP 12
.B SKINSDIR
Colon separated list of paths where Audacious should look for skin files.
.TP
.B TARCMD
Tar command supporting GNU tar style decompression.  Used for
unpacking gzip and bzip2 compressed skins.  Default is \fItar\fP.
.TP
.B UNZIPCMD
Command for decompressing zip files (skins).  Default is \fIunzip\fP.

.SH "SEE ALSO"
.BR audtool (1)

.SH WEBSITE
.I https://audacious-media-player.org
